home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / show / tigashow.lha / TigaShow / TigaShow.doc < prev    next >
Encoding:
Text File  |  1994-03-29  |  4.0 KB  |  110 lines
  1. **** Documentation for TigaShow ***
  2. **** (just a few lines indeed) ****
  3. ***********************************
  4. ******** this is version 1.5 ******
  5. **** written by Thomas Herlyn *****
  6. ***********************************
  7. *********** GiftWare **************
  8. ***********************************
  9.  
  10. Introduction:
  11. -------------
  12. This program displays images on the Commodore A2410/TIGA graphics board.
  13. Currently images stored in the common GIF (Graphic Interchange Format, 
  14. by CompuServe), JPEG (thanks to the independant JPEG group) and PPM
  15. (thanks to people supporting the NETPBM package) are supported.
  16. This is the first PD-program specialized to this board, I think
  17. (Laire, your PostView doesn't work on my board, unfortunately).
  18. It is Giftware in the current development phase. This means you don't have
  19. to pay anything, but if you use it often and / or you love it, please send
  20. me anything you want (mails, presents, programs, ZIP-Rams for A3000 etc.).
  21. The Copyright remains to me.
  22.  
  23. Requirements:
  24. -------------
  25. - at least Kickstart 1.3
  26. - C= A2410/TIGA graphics board
  27. - A2410.DEVICE in DEVS:
  28. - TIGA initialized by the command LOADTIGA
  29. - IEEE libraries (by C=) in LIBS:
  30. - JPEGTMP: assigned anywhere to your harddisk (or to RAM, if you have 
  31.   lots of it)
  32. - JPEGMEM (an environment variable) set to the amount of ram in KBYTEs you
  33.   think you can afford for viewing JPEGs
  34. - a few images (* grin *)
  35.  
  36. Installation:
  37. -------------
  38. Copy TigaShow anywhere you want. Assign JPEGTMP: to a place with a lot of 
  39. free RAM (for example to your Harddisk or RAM:), 
  40. example: Assign JPEGTMP: WORK: . Set the environment variable JPEGMEM to the
  41. amount of RAM in KBYTES you think you can afford for viewing JPEGs, example:
  42. SetEnv JPEGMEM 200 (200 KBytes for JPEGs), more memory gets allocated on
  43. JPEGTMP: . SetEnv JPEGMEM 0 will work, too. That's it!
  44.  
  45. Usage:
  46. ------
  47. from CLI: TigaShow <Path and Filename>
  48.  
  49. from Workbench: Click on TigaShow icon, SHIFT-DoubleClick on the image icon,
  50.  
  51. then look... 
  52. and be amazed.
  53.  
  54. for a little diashow:
  55. from CLI: TigaShow <Path1 and Filename1> <Path2 and Filename2> <...>
  56.  
  57. from Workbench: Click on the TigaShow icon, SHIFT-click the next image icons
  58.                 and SHIFT-doubleclick the last image icon,
  59.  
  60. Features:
  61. ---------
  62. - quite fast (especially on GIFs, slower on JPEGs and slow on PPMs, I think)
  63. - centers the picture if it is smaller than the standard TIGA screen
  64. - does (Floyd-Steinberg) dithering on JPEGs and PPMs
  65. - Diashow option
  66. - can be invoked by CLI and WB (look above for USAGE)
  67. - supports GIF, JPEG, PPM
  68. - uses IEEE libraries, so automatically uses math coprocessor if available
  69.  
  70. SoonToCome (ToDo);
  71. ------------------
  72. - scrolling for pictures larger than the TIGA screen.
  73. - IFF support
  74. - File requester
  75. - GrayScale forcing
  76.  
  77. Hints:
  78. ------
  79. You can use TigaShow for looking IFFs, too. You can convert any IFF to a PPM
  80. format first (with ILBMTOPPM) and watch this PPM image with TigaShow. Using 
  81. the NETPBM package you are able to view any type of image format. Get it if 
  82. you want to view a picture whose format is not supported by TigaShow yet, I
  83. can't think of a format not supported by NETPBM.
  84. Unfortunately, piping is not possible anymore due to the automatic picture
  85. type recognition of TigaShow.
  86.  
  87. Comments:
  88. ---------
  89. A2410.DEVICE and LOADTIGA are not included since these are copyrighted
  90. by Commodore, I think. You have to get them elsewhere.
  91. Interlaced GIFs are not supported yet.
  92. If you are interested in a version specialized to 68030/68881 please contact
  93. me (I personally use this version, but have not compared the speed of this
  94. IEEE library version to the 030/881 one yet).
  95.  
  96. Credits:
  97. --------
  98. The source is loosely based on the source of the JPEG distribution of the 
  99. Independant JPEG Group and and on ppmqvga included in the NETPBM package.
  100. Many thanks to the authors.
  101.  
  102.                                             Thomas Herlyn
  103.  
  104. Send Bug reports, gifts, mails etc. to
  105.  
  106. Thomas Herlyn                EMail: Thomas.Herlyn@Informatik.Uni-Oldenburg.DE
  107. bei Willms                   IRC:   tomh
  108. Rostocker Strasse 29
  109. Germany 26121 Oldenburg
  110.